Introduction

이 문서에서는 YouTube Analytics API와 YouTube Reporting API에서 YouTube 분석 데이터에 대한 액세스를 제공하는 방식의 유사점과 차이점을 설명합니다. 이 문서의 목적은 애플리케이션에 적합한 API를 선택하는 데 도움을 주는 것입니다.

두 API 모두 개발자가 YouTube 분석 데이터를 검색할 수 있게 해줍니다. 또한 두 API 모두 YouTube 채널 소유자와 YouTube 콘텐츠 소유자를 지원하며 각 소유자는 특정 보고서 집합에 액세스할 수 있습니다.

  • 채널 보고서는 특정 채널의 사용자 활동 측정항목을 포함합니다.

  • 콘텐츠 소유자 보고서는 지정된 YouTube 콘텐츠 소유자와 연결된 모든 채널의 측정항목을 집계합니다. 예를 들어 음반사는 모든 음반사 아티스트의 YouTube 채널에 대한 통합 통계가 포함된 보고서를 검색할 수 있습니다. 일부 콘텐츠 소유자 보고서에는 사용자 활동 측정항목이 포함되고, 수익 및 광고 실적과 관련된 측정항목이 포함되는 보고서도 있습니다.

또한 Reporting API를 사용하면 일부 콘텐츠 소유자가 시스템에서 관리하는 광고 수익 보고서에 액세스할 수 있습니다. 시스템 관리 보고서의 데이터는 Reporting API를 통해서만 검색할 수 있습니다.

모든 YouTube 분석 및 YouTube Reporting API 요청은 요청된 데이터를 소유한 채널 또는 콘텐츠 소유자의 승인을 받아야 합니다.

보고서 내용

API가 검색하는 보고서에는 다음 두 가지 유형의 데이터가 포함됩니다.

  • 측정기준은 사용자 활동이 발생한 날짜 또는 사용자 거주 국가 등의 데이터를 집계하는 데 사용되는 일반적인 기준입니다.

    보고서의 각 데이터 행에는 측정기준 값의 고유한 조합이 있습니다. 따라서 각 행의 측정기준 값 조합이 해당 행의 기본 키로 작동합니다.

  • 측정항목은 사용자 활동, 광고 실적 또는 예상 수익에 대한 개별 측정값입니다. 사용자 활동 측정항목에는 동영상 조회수, 평점 (좋아요 및 싫어요) 등이 포함됩니다.

애플리케이션에 적합한 API 선택

YouTube Analytics API
YouTube Analytics API는 맞춤 YouTube 분석 보고서를 생성할 수 있도록 실시간 타겟팅된 쿼리를 지원합니다. API가 필터링 및 정렬 매개변수를 제공하므로 호출하는 애플리케이션이 이러한 함수를 기본적으로 지원할 필요가 없습니다.

각 API 요청은 데이터를 반환할 기간을 지정합니다. 또한 API를 사용하면 주별 및 월별 데이터 세트를 검색할 수 있습니다. 따라서 호출 애플리케이션은 검색된 데이터 세트를 저장하거나 여러 기간에 걸쳐 통계를 집계할 필요가 없습니다.
YouTube Reporting API
YouTube Reporting API는 채널 또는 콘텐츠 소유자의 YouTube 분석 데이터가 포함된 일괄 보고서를 검색합니다. 대규모 데이터 세트를 가져올 수 있고 해당 데이터를 필터링, 정렬, 마이닝할 수 있는 도구를 제공하는 애플리케이션용으로 설계되었습니다.

각 보고서에는 사전 정의된 필드가 포함되어 있습니다. 개발자는 API를 사용하여 보고 작업을 예약합니다. 각 작업은 YouTube에서 생성해야 하는 보고서를 식별합니다. 그러면 YouTube에서 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다. 각 보고서에는 고유한 24시간 동안의 데이터가 포함되어 있습니다.

또한 YouTube는 YouTube 크리에이터 스튜디오에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템 관리 보고서 집합을 자동으로 생성합니다. 이 보고서는 광고 수익 데이터에 대한 프로그래매틱 액세스를 제공합니다.

지원되는 보고서

다음 표에는 API를 사용하여 검색할 수 있는 다양한 유형의 보고서가 나와 있습니다. 타겟팅된 쿼리는 YouTube Analytics API를 통해 사용할 수 있고, 일괄 보고서는 YouTube Reporting API를 통해 사용할 수 있습니다.

한 API에서 사용할 수 있는 데이터를 다른 API에서는 사용하지 못할 수 있습니다. 예를 들어 YouTube Analytics API에서는 주별 또는 월별로 사용자 활동 측정항목을 검색할 수 있지만, YouTube Reporting API를 사용하려면 사용자가 직접 해당 데이터를 집계해야 합니다. 반면 YouTube Reporting API는 콘텐츠 소유자의 저작물 보고서를 지원하지만 YouTube Analytics API에서는 해당 데이터를 사용할 수 없습니다.

보고서 유형
동영상 보고서 채널 (쿼리 또는 일괄) 및 콘텐츠 소유자 (쿼리 또는 일괄)에 지원됩니다.

동영상 보고서는 채널의 동영상 또는 콘텐츠 소유자의 동영상과 관련된 모든 사용자 활동에 대한 통계를 제공합니다. 예를 들어 이 보고서에는 동영상에서 발생한 조회수가 포함됩니다. YouTube Analytics API에서 일부 콘텐츠 소유자 동영상 보고서에는 예상 수익 및 광고 실적 측정항목도 포함됩니다.
재생목록 보고서 채널 (쿼리 또는 일괄) 및 콘텐츠 소유자 (쿼리 또는 일괄)에 지원됩니다.

재생목록 보고서는 특히 재생목록에서 발생하는 동영상 조회수와 관련된 통계를 제공합니다. YouTube Reporting API는 재생목록에 대한 시청 지속 시간 보고서를 지원하지만 YouTube Analytics API는 유사한 보고서를 지원하지 않습니다.
광고 실적 보고서 콘텐츠 소유자에게 지원됩니다 (쿼리 또는 일괄).

광고 실적 보고서는 동영상 재생 중에 실행된 광고의 노출수 기반 측정항목을 제공합니다. 이러한 측정항목은 각 광고 노출을 설명하며, 각 동영상 재생 시 여러 번의 노출이 발생할 수 있습니다.
예상 수익 보고서 콘텐츠 소유자에게 지원됩니다 (일괄).

예상 수익 보고서는 Google 판매 광고 소스 및 광고가 아닌 소스에서 비롯된 동영상의 총 예상 수익을 제공합니다. 이 보고서에는 광고 실적 측정항목도 몇 가지 포함되어 있습니다. 시스템 관리 보고서에는 실제 수익이 포함됩니다.
저작물 보고서 콘텐츠 소유자에게 지원됩니다 (일괄).

저작물 보고서는 콘텐츠 소유자의 저작물에 연결된 동영상과 관련된 사용자 활동 측정항목을 제공합니다. 콘텐츠 소유자가 콘텐츠 소유자의 저작물 중 하나와 일치하는 동영상으로 소유권을 주장한 경우 해당 동영상은 콘텐츠 소유자의 보고서에 포함됩니다. 해당 동영상은 콘텐츠 소유자 또는 다른 YouTube 사용자가 업로드했을 수 있습니다.
시스템 관리 보고서 YouTube 크리에이터 스튜디오의 보고서 메뉴에서 관련 보고서에 액세스할 수 있는 콘텐츠 소유자에게 지원됩니다.

시스템 관리 보고서는 저작물과 동영상에서 얻은 실제 수익 데이터를 제공합니다. 추가 보고서에는 소유권 주장이 제기된 동영상 및 이와 일치하는 동영상이 표시됩니다. 현재 API를 통해 제공되는 크리에이터 스튜디오 보고서 중 일부는 없습니다.

참고: YouTube는 크리에이터 스튜디오에서 해당 보고서에 액세스할 수 있는 콘텐츠 소유자를 위해 시스템 관리 보고서를 자동으로 생성합니다. 따라서 이러한 보고서를 가져오는 프로세스는 이 목록에 있는 다른 유형의 보고서와 다릅니다. 자세한 내용은 시스템 관리 보고서 문서를 참조하세요.

주요 차이점

다음 표는 YouTube 분석과 Reporting API의 중요한 차이점을 보여줍니다.

기능 YouTube Analytics API YouTube Reporting API
데이터 검색 프로세스 각 API 요청은 반환될 측정기준과 측정항목과 데이터가 반환되는 기간을 지정합니다. 애플리케이션에서는 보고 작업을 예약합니다. YouTube는 각 작업에 대해 비동기식으로 다운로드할 수 있는 일일 보고서를 생성합니다.
기간 일부 API 보고서에는 사용자 활동이 발생한 날짜가 명시됩니다. 일부 보고서에서는 사용자 활동 측정항목을 월별로 집계하기 위한 측정기준을 지원합니다. 모든 API 보고서에는 사용자 활동이 발생한 날짜가 표시됩니다. API를 사용하는 애플리케이션은 주기적인 간격으로 데이터를 집계하는 기능을 구현할 수 있습니다.
데이터 필터링 측정기준에 특정 값이 있는 행만 포함하도록 보고서를 필터링할 수 있습니다. API는 필터로만 사용되는 대륙subContinent과 같은 일부 측정기준도 지원합니다. API는 전체 데이터 세트의 일괄 다운로드를 지원합니다. 필터 전용 측정기준에 대한 데이터 필터링 또는 반환은 지원하지 않습니다. 클라이언트 애플리케이션은 다운로드된 데이터를 저장하고 데이터를 필터링하는 자체 기능을 구현합니다.
정렬 반환된 측정항목 값을 기준으로 보고서를 정렬할 수 있습니다. 일부 보고서는 제한된 수의 결과만 지원합니다. 예를 들어 채널의 최다 조회 동영상을 나열하는 보고서는 최대 200개의 행을 반환합니다. 이 API는 전체 데이터 세트의 일괄 다운로드를 지원합니다. 클라이언트 애플리케이션은 다운로드한 데이터를 정렬하는 자체 기능을 구현할 수 있습니다.
열거형 API 보고서에는 열거된 측정기준 값을 식별하기 위한 'ANDROID' 또는 'CHANNEL'과 같은 텍스트 값이 포함됩니다. API 보고서에는 텍스트 값에 매핑할 수 있는 정수가 포함됩니다.
할당량 API 서버는 각 쿼리를 평가하여 할당량 비용을 결정합니다. 할당량 사용 섹션에서는 방법을 더 자세히 설명합니다. 데이터를 한 번 검색한 다음 애플리케이션 내에서 필터링, 정렬, 쿼리하기 때문에 할당량 사용은 문제가 되지 않습니다.
순 보고서
  • 자막과 관련된 사용자 활동
  • 재생목록의 시청 지속 시간 데이터
  • 콘텐츠 소유자의 예상 수익 보고서 (두 가지 보고서 사용 가능)
  • 콘텐츠 소유자를 위한 저작물 보고서 (11가지 보고서 사용 가능)
고유 측정기준 group (필터 전용 측정기준)
대륙 (필터 전용 측정기준)
subContinent (필터 전용 측정기준)
month
isCurated==1 (필터 전용 측정기준)
viewsPerPlaylistStart
averageTimeInPlaylist
annotation_id
annotation_type
asset_id
card_id
card_type
live_or_on_demand
subscribed_status
subtitle_language
순 측정항목 uniques
relativeRetentionPerformance
viewsPerPlaylistStart
averageTimeInPlaylist
card_click_rate
card_clicks
card_impressions
card_teaser_click_rate
card_teaser_clickscard_teaser_impressionsestimated_partner_adsense_revenueestimated_partner_doubleclick_revenueplaylist_saves_addedplaylist_saves_removed

API 간 이름 지정 차이

두 API는 현재 서로 다른 이름 지정 규칙을 사용하여 측정기준과 측정항목을 식별합니다. 현재 YouTube Analytics API 이름에는 camelCase를 사용하지만 YouTube Reporting API 이름에는 밑줄로 구분된 이름을 사용합니다.

다음 표에서는 두 API가 동일한 측정항목과 측정기준을 식별하는 데 사용하는 서로 다른 이름을 보여줍니다. 경우에 따라서는 이름을 camelCase에서 밑줄로 변환한 후 얻는 것보다 두 이름의 차이가 더 큽니다. 예를 들어 YouTube Analytics API에서 video 측정기준의 이름은 YouTube Reporting API에서 video_id입니다.

크기

YouTube Analytics API 이름 YouTube Reporting API 이름
adType ad_type
ageGroup age_group
asset asset_id
audienceType audience_retention_type
channel channel_id
claimedStatus claimed_status
contentOwner content_owner_id
country country_code
날짜
deviceType device_type
elapsedVideoTimeRatio elapsed_video_time_percentage
gender[성별] gender[성별]
insightPlaybackLocationDetail playback_location_detail
insightPlaybackLocationType playback_location_type
insightTrafficSourceDetail traffic_source_detail
insightTrafficSourceType traffic_source_type
liveOrOnDemand live_or_on_demand
operatingSystem operating_system
재생목록 playlist_id
province province_code
sharingService sharing_service
subscribedStatus subscribed_status
subtitleLanguage subtitle_language
uploaderType uploader_type
동영상 video_id

측정항목

YouTube Analytics API 이름 YouTube Reporting API 이름
adEarnings estimated_partner_ad_revenue
annotationImpressions annotation_impressions
annotationClickableImpressions annotation_clickable_impressions
annotationClicks annotation_clicks
annotationClickThroughRate annotation_click_through_rate
annotationClosableImpressions annotation_closable_impressions
annotationCloses annotation_closes
annotationCloseRate annotation_close_rate
audienceWatchRatio audience_retention_percentage
averageViewDuration average_view_duration_seconds
averageViewPercentage average_view_duration_percentage
cardClickRate card_click_rate
cardClicks card_clicks
cardImpressions card_impressions
cardTeaserClickRate card_teaser_click_rate
cardTeaserClicks card_teaser_clicks
cardTeaserImpressions card_teaser_impressions
댓글 댓글
싫어요 싫어요
수입 estimated_partner_revenue
estimatedMinutesWatched watch_time_minutes
estimatedPartnerAdSenseRevenue estimated_partner_adsense_revenue
estimatedPartnerDoubleClickRevenue estimated_partner_doubleclick_revenue
grossRevenue estimated_youtube_ad_revenue
impressionBasedCpm estimated_cpm
노출수 ad_impressions
좋아요 좋아요
monetizedPlaybacks estimated_monetized_playbacks
playbackBasedCpm estimated_playback_based_cpm
playlistStarts playlist_starts
savesAdded playlist_saves_added
savesRemoved playlist_saves_removed
공유 공유
subscribersGained subscribers_gained
subscribersLost subscribers_lost
videosAddedToPlaylists videos_added_to_playlists
videosRemovedFromPlaylists videos_removed_from_playlist
viewerPercentage views_percentage
조회수 조회수